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HP Domain ServiceControl 


HP Domain ServiceControl (hp dsc) is a web-based solution that 
provides the quality of service needed to maintain your web applications. 
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HP Domain ServiceControl 


hp dsc is made up of the following components: 

• hp ac - HP AdmissionControl controls the amount and length of 
sessions admitted to a web server such that the system does not 
become overloaded. 

• hp desms - HP Domain Enterprise Server Management System 
configures, administers, operates, and monitors your system 
including hp ac and hp ldc. 

• hp ldc - HP LocalDirector Controller automatically generates the 
information needed by Cisco's LocalDirector todistribute load and 
manage TCP/IP connections. 
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HP Domain ServiceControl 

Installation Requirements 


Installation Requirements 

The following is the list of requirements to install all the components of 
HP Domain ServiceControl (hp dsc). Ifyou are installing a subset of the 
components, go to the appropriate chapter(s) in this manual for more 
information. Information about HP Domain Enterprise Server 
Management System can be found in the Getting Started with HP 
Domain Software manual. 

Hardware 

• H P 9000 computer system 

• 32 M B of memory 

• CD-ROM drive to load the software 

Software 

• HP-UX 10.20 or 11.0 

• HP DESMS 

• Netscape Enterprise or FastTrack Server version 3.0 or later 

• Cisco LocalDirector version 2.1 or later 

Disk Space (Estimated) 

• 80 MB 

Installing HP Domain ServiceControl 

To install theHP dsc software, run swinstaii (as root) and install the 
bundlej 1592AA. 


Chapter 1 
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HP Domain ServiceControl 

Configuring HP Domain ServiceControl 


Configuring HP Domain ServiceControl 

Each component of hp dsc needs to be configured individually. Goto the 
following areas for more information about configuration: 

• hp ac - See Chapter 2, "HP AdmissionControl," on page 13. 

• hp desms - Seethe manual Getting Started with HP Domain 
Software. 

• hp ldc - See Chapter 3, "HP LocalDirector Controller," on page 39. 

Alsorefer totheHP Domain ServiceControl Release Note for other 
important information. 
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HP AdmissionControl 

What is HP AdmissionControl? 


What is HP AdmissionControl? 

HP AdmissionControl (hp ac) prevents a web server from becoming 
overloaded by controlling the amount and length of sessions admitted. 

Using theHP Domain Enterprise Server Management System (hp 
desms, H P's web-based Domain software administrator), you can 
configure when to admit new sessions (based on the system's load), when 
to end a session (based on the time interval between requests and/or the 
length of a session), and how to respond to a deferred session (redirect 
the request or return a rejection message). You can also display the 
status of all the systems in a web server's cluster and display 
performance statistics of hp ac. 

What is a Session? 

A session is an http request or sequence of http requests made to a web 
server by a single user. A simple session might consist of a request for a 
server's home page. If that page contains images, the session would also 
consist of requests for each image. 

A more complicated and longer session might consist of a request for a 
server's home page, following a link to a catalog, browsing the catalog 
and adding items to a shopping cart, and finally supplying payment 
information to complete a purchase. 

When Does a Web Server Become Overloaded? 

A web server becomes overloaded when there are too many requests for 
the server to fulfill; the server runs out of resources. Requests may be 
delayed or dropped. For example, a user involved in a long session may 
experience poor performance or may have to reload a page more than 
once for it to display. 

How Does HP AdmissionControl Work? 

hp ac monitors the resources and the number of arriving sessions on the 
web server. Based on available resources and how hp ac is configured, it 
will accept or defer a session, hp ac makes sure the web server does not 
become overloaded by deferring any new sessions for which it does not 
have resources. It also allows an admitted session to be completed. 
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HP AdmissionControl 

What is HP AdmissionControl? 


When the web server's resources are available, hp ac allows the session 
to begin and will fulfill all requests made during this session, hp ac 
monitors the time between requests as well asthelength of the session. 
If one of these variables exceeds the thresholds configured in hp ac, the 
session is terminated. Otherwise, all requests are fulfilled until the 
session is completed. 

When the web server's resources are not available, hp ac will defer the 
session. The web administrator can chooseto redirect the request to 
another server or serve a page with an error message or some helpful 
information. 
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HP AdmissionControl 

Installing HP AdmissionControl 


Installing HP AdmissionControl 

HP AdmissionControl (hp ac) is part of the H P Domain ServiceControl 
(hp dsc) product. You do not needtoloadtheentireHP dsc product if you 
only want to use hp ac. 

Installation Requirements 

Hardware 

• H P 9000 computer system 

• 32 M B of memory 

• CD-ROM drive to load the software 

Software 

• HP-UX 10.20 or 11.0 

• Netscape FastTrack Server version 3.0 or later OR 
Netscape Enterprise Server version 3.0 or later 

Disk Space (Estimated) 

• 38 MB 

I nstal I i ng the Software 

To install hp ac, run swinstaii (as root), double-click on the bundle 
J 1592AA to view the software, and select the hp ac software. 
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Configuring HP AdmissionControl 


Configuring HP AdmissionControl 

If Netscape Enterprise Server version 3.0 or later was already installed 
on your system in the /opt/ns-enterprise3 directory before you 
installed HP Domain ServiceControl, hp ac is automatically configured 
and enabled on your system. 

If Netscape FastTrack Server version 3.0or later was already installed 
on your system in the /opt/ns-ftrack directory before you installed 
HP Domain ServiceControl, hp ac is automatically configured and 
enabled on your system. 

If both servers were already installed on your system before you 
installed HP Domain ServiceControl, hp ac is automatically configured 
and enabled for your Netscape Enterprise Server. 

If neither server was installed beforeyou installed HP Domain 
ServiceControl, you must first install the Netscape Enterprise Server 
version 3.0 or later or Netscape FastT rack Server version 3.0 or later and 
then run the setup script (seethe next section for information about 
runni ng the setup scri pt). 

If you installed either server after installing HP Domain ServiceControl, 
you must run the setup script (see next section for information about 
runni ng the setup scri pt). 

If you installed either server in another server root directory other than 
/opt/ns-enterprise3 (for the Netscape Enterprise Server) or 
/opt/ns-ftrack (for the Netscape FastTrack Server), you must run the 
setup script (seethe next section for information about running the 
setup script). 

Running the setup Script 

You should only run the setup script if you installed the Netscape 
Enterprise Server or Netscape FastTrack Server after installing HP 
Domain ServiceControl or if the server root directory is something other 
than / opt/ns-enterprise3 (for the N etscape E nterprise Server) or 
/opt/ns-ftrack (for the Netscape FastTrack Server). 

To run the setup script, type: 

/opt/hpac/setup 
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HP AdmissionControl 

Configuring HP AdmissionControl 


At the Root pathname of Netscape server prompt, enter the 
Netscape Server root directory. 

The setup script will automatically configure and enable hp ac. 

Default values set for all applicable configuration parameters are listed 
at the end of this chapter. 

Setting the Configurable Parameters 

You can edit the configuration parameters in three different ways: 

• You can access the 

"H P AdmissionControl Settings" administration web page at the URL 
http : //system_name/hpac. Your Netscape Server must be 
running to access this page. Use the system's root user and password 
to access this page. 

• You can edit the configuration file 
/opt/ns-server_name/server_id/config/hpac/config.ac 

• You can use the HP DE SM S i nterface to access the "H P 
AdmissionControl Settings"administration web page(HP ac is 
located under Server Control). Your Netscape Server and HP 
administration server must be running. 

To start the HP administration server, type 
/opt/hpwebsuite/start-admin and go to the URL 
http : //system_name: 8181/. The default user ID is hpadmin; and 
the default password is hpadmin. 

To access hp ac, you must enter the system's root user and password. 
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Configuring HP AdmissionControl 


The foil owing is an example of the "HP AdmissionControl Settings" page: 
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The foil owing sections describe the parameters that can beset using the 
"HP AdmissionControl Settings" administration web page. All 
configurable parameters in the configuration file are listed at the end of 
this chapter. 
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HP AdmissionControl 

Configuring HP AdmissionControl 

Admit Sessions 

For the default value, the load threshold is set to 2. 


HP AC Configurable Parameters: Admit Sessions 


Parameter 

Description 

Shutdown 

After the specified number of seconds, do not admit 
any new sessions and reject all remaining sessions. 

Always 

DisableHP ac and admit all sessions to the web 
server. If you are permanently disabling hp ac, you 
should remove hp ac from you system (see 
"Removing HP AdmissionControl"on page 26for 
more information). 

Load 

If the load is less than this specified amount, admit 
the session. The load threshold works best when a 
web application is processor-intensive. 


To calculate the load threshold, do the foil owing: 

1. Run thetop command. Note the first listed "Load averages" and the 
percentage listed under "I DLE " of "Cpu states". 

Sample Output from the top Command 

System: web_server Wed Apr 22 10:41:59 1998 

Load averages: 1 . 45 , 1.46, 1.78 

149 processes: 145 sleeping, 3 running, 1 stopped 
Cpu states: 

LOAD USER NICE SYS IDLE BLOCK SWAIT INTR SSYS 
1.45 100.0% 0.0% 0.0% 0 . 0 % 0.0% 0.0% 0.0% 0.0% 

2. If I DLE is greater than zero, then set the threshold to 
(100- IDLE)/100. 

If I DLE equals zero, then set the threshold to the first listed load 
average. 

Using the above sample output, you would set the load threshold to 
1.45. 

Run top when performance is poor and acceptableto determine an 
acceptable load level. 
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Configuring HP AdmissionControl 


Table 2-2 


Table 2-3 


End Sessions 

For the default, the interval between requests is set to 600 seconds (10 
minutes) and the session duration is disabled. 


HP AC Configurable Parameters: End Sessions 


Parameter 

Description 

1 nterval 
between 
requests 

The amount of time, in seconds, between requests 
within the session. If the time between requests 
exceeds the specified threshold, the session is ended. 

Session 

duration 

The amount of time of the session. If the session 
exceeds the specified threshold, the session is ended. 
Set this parameter to zero to disable this threshold. 


Respond to Rejected Sessions 

Rejected sessions can either be redirected or served a web page 
containing a standard error message or other information. 

If redirection is disabled or the redirect request is not accepted, a web 
page containing a standard error message or other information is 
returned. 

The default is to disable redirection and serve an error pagetoa rejected 
session. 


HP AC Configurable Parameters: Redirect Rejected Sessions 


Parameter 

Description 

Disable 

Do not redirect the rejected session. 1 nstead, return 
a web page with an error message or other 
information. 

Address 

Redirect the rejected session to a load balancing 
system (such as a cluster manager), to another web 
server, or to another system set up to specifical ly 
handle rejected sessions. Specify the full domain 
name or 1P address. 

Cluster 

Redirect the rejected session to a randomly selected 
member of a cl uster. 
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HP AdmissionControl 

Configuring HP AdmissionControl 


Table 2-4 


Parameter 

Description 

Domain 

Redirect the rejected session to the domain to which 

the systems in the cluster belong. For example, if 

the cl uster consists of the two systems 

wwl.sales.acme.com and 

ww2 . sales. acme. com, specify the domain as 

. sales. acme. com. Note the leading dot. 


The domain specifies the scope over which the 
client-side cookies can be shared (hp ac uses 
client-side cookies to encode session information). 

Group 

The cl uster group to which this system belongs. 

TTL 

Time to Live. The number of redirections allowed 
before rejecting the session. Add one to the TTL 
parameter to get the number of redirects. For 
example, setting the TTL to 0 allows one 
redirection. Setting the TTL to 1 allows two 
redirections. 


It is recommended that theTTL beset to a value no 
larger than 2. 


When redirection is disabled, the foil owing types of web pages can be 
served: 


HP AC Configurable Parameters: Respond to Rejected Sessions 


Parameter 

Description 

Error 

The "Server Temporarily Unavailable" error message 
is served to rejected requests. This is the easiest but 
least informative way to respond to a rejected request. 
Extra load on the system may be generated by users 
trying to immediately re-establish a connection. 

Page 

The specified web page is served to rejected requests. 
You can provide information to the customer such as 
why the session was rejected and when would be a 
more opportune time to return tothesite. A user is less 
likely to try immediately re-establishing a connection 
and more likely to return to the site. 
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Configuring HP AdmissionControl 


Parameter 

Description 

Allocate 

sessions 

A "countdown" web page is served to rejected requests. 
The user is asked to wait a certain amount of time 
before getti ng access to the site. This type of session is 
given priority over new sessions. 

E nter the number of sessions you wish to have 
admitted each minute. For example, if you allocate five 
sessions per minute, one session will be admitted every 
twelve seconds. If seven sessions are rejected, five will 
be admitted the next mi nute and two will be admitted 
the minute after. Makesure the allocation rateisless 
than the system's capacity. 

You may want to compensate the allocation for 
no-shows. 

Monitoring the "% Priority Requests" statistic will 
show the system's load due to priority sessions. Reduce 
the allocation rate if the number approaches or is over 
50%. 

Also monitor the "Last Allocation Delay"statistic. It 
shows how long a deferred user waited before his/her 
session was admitted. 

External 

Use an external function or application. For example, 
the user could be offered a discount or other incentive 
to return to the site; or, the user could be offered to 
enroll in a service plan that guarantees access to the 
site. Currently, no supported functions or applications 
exist. If selected, the Error page is returned. 

Exclude 

After the initial rejection, the user is prevented from 
returni ng to the site after the specified amount of ti me 
(in seconds). This discourages a user from trying to 
immediately re-establish a connection. 

If a session is allocated, this isthe minimum delay that 
can be scheduled. 
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Configuring HP AdmissionControl 

Creating an Allocation Page for Rejected Sessions 

The following isthe default allocation page served to the user: 

Server Busy 

We are sorry our server is busy, and in order to ensure adequate 
levels of service to our current visitors, we cannot serve you at 
this time. We have allocated you a position in line and will serve 
you as soon as we can. 

You will automatically enter the site in 1:23 (minutes:seconds). 

To change the content of this page, you must edit the file 

/opt/ns-server_name/server_id/config/hpac/conf ig. ac 

To change the "Server Busy" title, edit the deferral.title parameter. To 
change the content of the message, edit the deferral.message 
parameter. To edit the countdown line, edit the deferral.enterMsg 
parameter. Note that each parameter is ended by a single period on its 
own line. 

The default allocation page would include the foil owing entries in the 
config.ac file: 

deferral.title 
Server Busy 

deferral.message 

We are sorry our server is busy, and in order to ensure 
adequate levels of service to our current visitors, we 
cannot serve you at this time. We have allocated you a 
position in line and will serve you as soon as we can. 

deferral.enterMsg 

You will automatically enter the site in 
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Configuring HP AdmissionControl 


Starting HP AdmissionControl 

hp ac is automatically enabled after you have installed H P 
ServiceControl (provided you have met certain conditions; see 
"Configuring H P AdmissionControl" on page 17 for more information) or 
run the setup script (see "Running the setup Script" on page 17 for more 
information). 

I f you have stopped h p ac, then you can start it agai n by configuri ng and 
specifying the load from the "HP AdmissionControl Settings" 
administration web page. 

Stopping HP AdmissionControl 

To stop or disable hp ac, set the Admit Session to "Always" from the "H P 
AdmissionControl Settings” administration web page. 

If you are permanently stopping hp ac, you should remove hp ac from 
your system (see "Removing H P AdmissionControl"on page 26 for more 
information). Because hp ac does not cache html, performance may be 
slow for static pages. 
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Removing HP AdmissionControl 


Removing HP AdmissionControl 

To remove hp ac, do the foil owing: 

1. Type /opt/hpac/setup -r 

2. At the Enter root pathname of Netscape server prompt, 
enter the Netscape Server root directory. 
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Configuration Parameters 


Configuration Parameters 


Table 2-5 HP AC Configurable Parameters 


Parameter 

Range/Type 

Default 

Description 

admit.always 

N/A 

N/A 

Configures hp ac to always 
accept sessions. 

admit.load 

N/A 

N/A 

Sets the "Admit Sessions" to 
use the load threshold. 

admit, load.threshold 

0.0 <=x 

2.0 

Sets the load threshold for 
admitting a session. 

admit, priority.damping 

0.0 <=x <=1.0 

0.001 

The dampi ng factor used to 
compute the priority 
percentage. Larger values 
make the controller more 
responsive to recent activity. 

admit, priority.threshold 

0.0 <=x <=1.0 

0.9 

The val ue of the priority 
fraction when priority 
requests are rejected 
(0.9 =90% priority 
percentage). 

admit.shutdown 

N/A 

N/A 

Sets the "Admit Sessions" to 
shutdown. 

admit.shutdown.del ay 

0 <=x (integer) 

600 

Sets how much time before 
hp ac shuts down and 
rejects all (new and 
remaining) sessions. 

cl uster.di sable 

N/A 

N/A 

Disables clustering. The 
system wi 11 not try to open 

the hpac-cluster port. 
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Configuration Parameters 


Parameter 

Range/Type 

Default 

Description 

cluster, domain 

string 


The domai n used to 1 i mit the 
scope of the cl uster over 
which the client-side 
cookies can be shared. 

cluster.group 

string 

default 

Sets the cluster group. 

cl u ster. keepa 1 i ve. i nter va 1 

1 <=x (integer) 

60 

The number of seconds 
between status broadcasts. 

cl uster. keepal i ve. mi sses 

1 <=x (integer) 

3 

The number of missed 
status broadcasts before a 
server is identified as down. 

cluster.TTL 

0 <=x (integer) 

0 

Sets the cl uster TTL which 
isthe number of redirections 
allowed before rejecting the 
session. 

cookie, password 

string 

N/A 

Sets the password used in 
creating the MD5 digest. 

deferral.enterMsg 

string 

You will 
automatically 
enter the site in 

Part of the allocation page 
message served when a 
session is rejected. 

deferral, message 

string 

We are sorry our 
server is busy, 
and in order to 
ensure adequate 
levels of service to 
our current 
visitors, we 
cannot serve you 
at this time. We 
have allocated 
you a position in 
line and will 
serve you as soon 

as we can. 

Part of the allocation page 
message served when a 
session is rejected. 
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Configuration Parameters 


Parameter 

Range/Type 

Default 

Description 

deferral.title 

string 

Server Busy 

Part of the allocation page 
message served when a 
session is rejected. 

endsession.duration 

0 <=x (integer) 

0 

Sets, i n seconds, the 
maximum session duration 

endsession.requestl nterval 

0 <=x (integer) 

300 

Sets, i n seconds, the 
maximum interval between 
requests 

isolate.damping 

0.0 <=x <=1.0 

0.001 

The dampi ng factor used to 
compute the share of 
resources bei ng used by each 
virtual server. Larger values 
make the controller more 
responsive to recent activity. 

isolate, pattern 

string 

N/A 

The pattern used to identify 
virtual servers. If provide, 
hp ac will isolate traffic to 
each virtual server. 

load.damping 

0.0 <=x <=1.0 

0.1 

The dampi ng factor used to 
compute the web server 
load. Larger values make 
the controller more 
responsive to recent activity. 

log.file 

string 

N/A 

The full path name of the hp 
ac log file. The statistics 
from the "H P 
AdmissionControl 

Statistics" web page are 
logged tothis file. 

log. interval 

1 <=x (integer) 

600 

How often, in seconds, the 
statistics are logged to the 
log.file. 
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Configuration Parameters 


Parameter 

Range/Type 

Default 

Description 

mime.cache 

N/A 

See "Defaults 
Already 

Configured in 
config.ac" on 
page 32. 

The web server should cache 
the specified mi me types. 

mi me. nocache 

N/A 

N/A 

The web server should cache 
all but the specified mime 
types. 

mi me.type 

string 

N/A 

Specifies the mi me type 
used by the caching policy. 

reject.error 

N/A 

Server 

Temporarily 

Unavailable 

Sets the response to a 
rejected session to the 
"Server Temporarily 
Unavailable” error 
message. This message is 
not configurable. 

reject.excludeTime 

0 <=x 

300 

Sets how long, in seconds, 
the user is prevented from 
returning to the site. 

reject.external 

N/A 

Server 

Temporarily 

Unavailable 

Sets the response to a 
rejected session to use an 
external function or 
application. Currently, it 
will only serve the "Server 
Temporarily Unavailable" 
error message. 

reject.future 

N/A 

N/A 

Sets the response to a 
rejected session to a 
"countdown" web page. 

reject.future.rate 

1 <=x (integer) 

10 

Set the number of sessions 
that can be admitted each 
minute. 
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Parameter 

Range/Type 

Default 

Description 

reject, page 

N/A 

N/A 

Sets the response to a 
rejected session to a 
customizable web page. 

reject, page, path 

string 

N/A 

The full path and file name 
of the customizable web 
page. 

shlib.initialize 

string 

N/A 

The name of the function 
that initializes the library. 

shlib.library 

string 

N/A 

The file name of the shared 
library. 

shlib.loadMetric 

string 

N/A 

The name of the function 
used as the load metric. 

sh lib. release 

string 

N/A 

The name of the function 
that releases resources 
al 1 ocated by the 1 i brary. 

shlib.reject 

string 

N/A 

The name of the function 
used when the reject policy 
is set to External. 

sh lib. session St ate 

string 

N/A 

The name of the function 
that modifies the session 
state. This function may 
change the priority of 
sessions or end sessions. 
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Defaults Already Configured in config.ac 

The following are defaults that have been configured in the 
/opt/ns-server_name/server_id/config/hpac/config.ac file: 

# Warning, manual changes to this file will be 

# overwritten by changes made 

# via the Admission Control Policy screen. 

mime.cache # a list of likely cache candidates follows 

mime.type audio/basic 

mime.type audio/midi 

mime.type audio/x-wav 

mime.type audio/x-liveaudio 

mime.type audio/x-pn-realaudio 

mime.type image/fif 

mime.type image/gif 

mime.type image/ief 

mime.type image/ifs 

mime.type image/jpeg 

mime.type image/tiff 

mime.type image/wavelet 

mime.type image/vnd 

mime.type image/x-photo-cd 

mime.type video/mpeg 

mime.type video/quicktime 

mime.type video/x-mpeg2 

mime.type video/x-msvideo 
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Table 2-6 


Logging HP AdmissionControl 
Information 

Saving I nformation to the Server Access Log 

hp ac admission decisions can be saved to the server access log. To 
include them, do the foil owing: 

1. Start the Netscape Administration Server. 

2. Select the server to configure. 

3. Click on Server Status. 

4. Select Log Preferences. 

5. Enter the name of the new access logfileto create (Netscape will not 
let you change the format of a Iogfile that is in use). 

6. Select Custom format near the bottom of the page. 

7. Append %Req->vars . hpacSessionState% at the end of the 
Custom format field. Be sure to include a space at the beginning of 
this entry to separate it from the other entries. 

8. Click ok to make the change. 

9. Click on Save and Apply to save your changes. 

One of the foil owing values will be logged to the access logfil e: 

Admission Decision Log Values 


Value 

Description 

- 

A management request was served from the cache. 

2 

The request was rejected. 

3 

The request was processed as part of a basic priority session. 

4 

The request was processed as part of a high priority session. 

5 

The request was deferred to a future time slot. 

6 

The request was redirected to another server. 
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Table 2-7 


Logging Statistics to a File 

The statistics displayed on the "HP AdmissionControl Statistics" web 
page can be logged to a file. To log the statistics to a file add the foil owing 
I i nes to 

/opt / ns -server name/server id/ config/hpac/config. ac: 

log. file filename 
log.interval seconds 

Where filename is the name of the fi le to which to save the statisti cs and 
seconds is how often the statistics are saved (in seconds). The 
log. interval default is 60 seconds. 

Restart the web server for the changes to take effect. 

The following is an exampleof a log entry: 

10/Mar/1998:20:39:00, 15,0,0,0,0,0,0,0,181,0,0,0.5,0.00, 92 

where each field is delimited by a comma. The fields are: 

HP AC Log File Statistics 


Statistic Name 

Example Value 

Time (GMT) 

10/M ar/1998:20:39:00 

Basic Sessions 

15 

Priority Sessions 

0 

Redirected Sessions 

0 

Sessions Rejected 

0 

Sessions Rejected Again 

0 

Sessions Timed Out 

0 

Sessions Too Long 

0 

Bad MD5 Requests 

0 

Basic Requests 

181 

Priority Requests 

0 

Management Requests 

0 

Load 

0.5 

Percentage Priority Requests 

0.00 

Last Allocation Delay 

92 
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Other Configuration Considerations 

This section covers tasks beyond basic configuration. 

Tuning Your Web Server's Cache 

To control session admissions, hp ac tracks the session state by including 
cookies in http responses. For hp ac to operate effectively, the server 
cannot generate all of its responses from the cache. This may cause the 
performance of the web server to be slow. 

However, you can tune the cache by configuring the 
/opt/ns-server_name/server_id/config/hpac/config.ac file to 
allow specified mime types to be cached or not cached. 

For example, if you serve http pages with embedded images, you can 
cache the images by adding the foil owing lines to the configuration file: 

mime.cache 

mime.type image/gif 

mime.type image/jpeg 

Or, if your pages are generated by an application such as an nsapi 
pi ug-i n or cgi scri pt, you can al I ow al I mi me types to be cached except for 
the mi me types associated with the application. For example, to cache all 
mi me types except those generated by cgi scri pts, add the fol lowi ng I i nes 
to the configuration file: 

mime.nocache 

mime.type magnus-internal/cgi 

You must restart the web server if you makechangestotheconfiguration 
file. 

If a page is not cachable, such as a dynamically created page or other 
pages marked by nsapi as uncachable, you cannot cache it even if you 
specify it in the configuration file as cachable. 
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Allowing Equal Access to a System's 
Resources 

If a web server hosts multiple virtual web sites, hp ac can be configured 
to balance traffic between each site, allowing each site to share the 
system's resources equally. 

The description or pattern of the web servers' document roots for each 
virtual server must be configured in the 

/opt/ns-server_name/server_id/ conf ig/hpac/conf ig. ac 

configuration file, hp ac uses the isolate .pattern parameter to 
monitor each site's traffic. You must restart the web server after editi ng 
the configuration file. 

For example, a system is hosting two web sites for Company A and 
Company B. Company A's home page is located at 

/web_pages/company_a/index. html and Company B’s home page is 
located at /web_pages/company_b/index . html. To monitor each 
site's traffic, add the following tothe configuration file: 

isolate.pattern /web_pages/%[ A /] 

Refer to documentation on the sscanf command for more information 
on constructing the pattern. 

After editing the configuration file, restart the web server. 

Detecting Failed Servers in a Cluster 

When a web server is running, it periodically broadcasts a message that 
it is up. When a web server is shut down, it broadcasts a message that is 
unavailable. When a web server is not running, it does not broadcast a 
message. 

Each web server in a cluster listens for these broadcast messages. Based 
on the messages received or not received, it will mark each system as up 
or down. 

The web server marks a system as up when it receives the appropriate 
broadcast message from that system. The web server marks a system as 
down when it receives the appropriate message or it fails to receive a 
message after a specified number of broadcast intervals. 
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In the hp ac 

/opt/ns -server name/server id /config/hpac/config. ac 

configuration file, you can configure how often messages are sent 
(broadcast interval) and how many messages can be missed before the 
system is marked as down. THe parameters are: 

cluster.keepalive.interval 60 
cluster.keepalive.misses 3 

where the interval is measured in seconds. The values given arethe 
default values. 

I f you configure these parameters, the web server must be restarted. 
Also, all systems in the cluster should use the same values for these 
parameters. 

Decreasi ng the broadcast i nterval decreases the ti me it takes to detect a 
failure. However, it also increases broadcast traffic. 

Sometimes, not all broadcast messages are received. Therefore, the 
number of misses should be set to a value greater than one. However, in 
a large cluster, removing a machine falsely does not severely impact the 
cluster's capacity and improves the responsiveness to failures. 

The maximum time to detect a failure can be determined by multiplying 
the broadcast interval by the number of misses. For the default values, 
the maximum failure detection time is three minutes. 
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What is HP LocalDirector Controller? 


What is HP LocalDirector Controller? 

HP LocalDirector Controller (hp ldc) works with Cisco LocalDirector by 
automatically generating the information needed by Cisco LocalDirector 
to load balanceTCP/l P traffic across multi pie servers . hp ldc, 
specifically the HP LocalDirector Control daemon (idc_agt), must be 
configured and running on each system that is managed by Cisco 
LocalDirector. Information regarding Cisco Local Director can be found at 
the URL http ://www.cisco.com/warp/public/751/lodir/. 


H P 9000 



H P 9000 


The information generated by hp ldc is referred to as "weights" in this 
document. The weights help Cisco LocalDirector determine which 
system has the resources to process an incoming request. 

Initial weights are generated by the Webstone benchmark tool. Webstone 
generates traffic to a system and calculates the throughput based on 
getting different-sized static pages in three minutes. The throughput is 
used to calculate the initial weights. 

hp ldc adjusts the weights depending on CPU usage and system load. 
Both the CPU usage and system load (measured by a one minute average 
job queue) must reach their configured thresholds before the weights are 
lowered. The weights will range between one and the initial weights. 
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Installing HP LocalDirector Controller 

HP LocalDirector Controller (hp ldc) is part of the HP Domain 
ServiceControl (hp dsc) product. You do not need to load the entire hp 
dsc product if you only want to use hp ldc. 

Installation Requirements 

Hardware Requirements 

• H P 9000 computer system 

• 32 M B of memory 

• CD-ROM drive to load the software 

Software Requirements 

• HP-UX 10.20 or 11.0 

• HP DESMS 

• An HTTP server such as Netscape Enterprise or FastTrack Server 
version 3.0 or later 

• A web browser that supportsj DK 1.1, such as 
Netscape Navigator 4.05 or Microsoft I nternet Explorer 4.0 

Other Requirements 

• A system already running Cisco LocalDirector version 2.1 or later 

I nstal I i ng the Software 

To install hp ldc, run swinstaii (as root), double-click on the bundle 
J 1592AA to view the software, and select the hp ldc software. 
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Configuring Cisco LocalDirector 

Because HP LocalDirector Controller sends information to Cisco 
LocalDirector using SNMP traps, thesnmp-server host parameter must 
be configured in the Cisco LocalDirector. 

On a system managed by Cisco LocalDirector, run netstat -rn and 
check the routing table information. Use the IP address associated with 
the Cisco LocalDirector gateway to configure the snmp-server host 
parameter 

Refer to Cisco Local Director's manuals for information on setting this 
parameter and other configuration information. 
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Configuring HP LocalDirector 
Controller 

There are two components you need to configure before usingHP LDC:the 
HP LDControl server and the HP LDControl daemon. 

You must configure hp ldc using the HP Domain Enterprise 
Management System (hp desms). Instructions on how to start hp desms 
are included in this manual. For more information on hp desms, please 
refer to the Getting Started with HP Domain Software manual. 

Starting HP DESMS 

Tostart hp desms, do the foil owing: 

1. Start the HP administration server. Type the foil owing: 

/opt/hpwebsuite/start-admin 

2. Start a browser that supports frames, isj ava-enabled, and supports 
J DK 1.1. 

3. GototheURL 

http: //hostname: 8181 

where hostname is the name of the system on which you are running 
the HP administration server. 

Reload this page if you have visited this page prior to this 
installation. 

4. Enter the following administration user (server) ID and password: 

U ser ID : hpadmin 

Password: hpadmin (you may have changed this during the setup 
process) 

If you are starting hp desms for the first time, the page to configure the 
HP LDControl daemon is displayed. 


Chapter 3 


43 




HP LocalDirectorController 

Configuring HP LocalDirector Controller 


Configuring the HP LDControl Server 


After starting hp desms, click on "Service Control" from the side menu 
and then "Server Configuration."The following page displays: 
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Set the foil owing parameters to configure the HP LDControl server: 

Table 3-1 HP LDControl Server Configurable Parameters 


Parameter 

Description 

Server Directory 

The home directory of the web server. For 
example, /opt/ns-enterprise3. 

Port Number 

The port number used by the web server. This 
must be a non-SSL port number. For example, 80. 

Document 

Directory 

The document root di rectory of the web server. For 
example, 

/opt/ns-enterprise3/docs-https-default. 


The HP LDControl daemon must be started/restarted for these values to 
take effect. See "Starting and Stopping the HP LDControl Daemon" on 
page47 for more information on starting hp ldc. 


NOTE The web server configured i n the 

/ etc/hpldc/webs tone/ conf / server-list file must be running 
before the HP LDControl daemon is started. 
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Table 3-2 


Configuring the HP LDControl Daemon 

After starting hp desms, select "Service Control” from the side menu and 
then "Configuration."The following page displays: 



Set the foil owing parameters to configure the HP LDControl daemon: 


HP LDControl Daemon Configurable Parameters 


Parameter 

Description 

LocalDirector 

Hostname 

The hostname of the system on which Cisco 
LocalDirector is running. 

Dynamic Weight 

Starts/Stops the H P LDControl daemon. 

When activated, the daemon will monitor the 
system and adjust the weights, if necessary. 
When deactivated, the H P LDControl daemon 
sends the initial weights to Cisco 

LocalDirector and exits. 
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Parameter 

Description 

CPU Threshold 

The highest percentage the CPU usage 
should reach before the weight of the server is 
automatically decreased. Note that the run 
queue threshold (average load) must also be 
reached before the weights are adjusted. 

Default: 80 

Range: 50 - 100% (integer only) 

Run Queue Threshold 

The highest amount the average load should 
reach before the weight of the server is 
automatically decreased. Note that theCPU 
usage threshold must also be reached before 
the weights are adjusted. 

Default: 2 

Range: 1.0 -10.0 (real number) 

Time 1 nterval 

How often, in seconds, the thresholds are 
checked and adjustments are made, if needed, 
to the weights. 

Default: 5 seconds 

Range: 5 - 300 seconds (integer only) 


Click on "OK" to save your changes. The values are saved in the file 

/etc/opt/hpldc/conf/ldc.conf. 

NOTE The web server configured i n the 

/ etc/hpldc/webs tone/ conf/ server-list file must be running 
before the HP LDControl daemon is started. 
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Starting and Stopping the HP LDControl 
Daemon 

The HP LDControl daemon can be started and stopped frorrmp desms. 
Select "Service Control" from the side menu and then "Start/Stop 
Daemon." A page similar to the foil owing displays (what is displayed 
depends on the status of the HP LDControl daemon: running or not 
running): 


NOTE The web server configured i n the 

/ etc/hpldc/ webs tone/ conf / server-list file must be running 
before the HP LDControl daemon is started. 



Tostart orstoptheHP LDControl daemon from the command line, type: 
/opt/hpldc/bin/ldc_agt 
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Configuring a System with More than One 
LAN Card 

If the system on which you are running the Webserver has more than 
one LAN card, you must set thesnmp-server host and real parameters in 
Cisco LocalDirector. Do the foil owing: 

1. On the system with multiple LAN cards, run netstat -rnandcheck 
the routing table information. UsethelP address associated with the 
Cisco LocalDirector gateway to configure thesnmp-server host 
parameter of Cisco LocalDirector. 

2. On the system with multiple LAN cards, run 

nslookup localhostnameand use this IP address to configure the 
real parameter of Cisco LocalDirector. 

Refer to Cisco Local Director's manuals for information on setting these 
parameters. 
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Table 3-3 


Table 3-4 


Troubleshooting the HP LD Controller 

General Troubleshooting 

If an error occurs, check the following two log files for error messages, 
causes, and recommended acti ons: 

1. /var/opt/hpldc/ldc.log 

2. /var/opt/hpldc/webstone.log 


Problems Accessing the HP LD Controller 
from HP DESMS 

Browser E rror Message and Action 


Error 

Message 

Action 

Applet 

ConfApplet 
can't start. 

The browser that you are using to administer the 
system must support J DK 1.1 in order to run hpldc. 
Two browsers that support J DK 1.1 are Netscape 
Navigator 4.05 and Microsoft 1 nternet Explorer 4.0. 


HP LDControl Daemon 

If the H P LDControl daemon dies, check for the following error messages 
in the /var/opt/hpldc/ldc. log file. Complete the listed actions for 
the specified messages. 


HP LDControl Daemon Error Log Messages and Actions 


Error 

Message 

Action 

Cannot open 
file filename. 

Check that thefilefilenameexists and that the H P 
LDControl daemon has write permission to its 
di rectory. 
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Error 

Message 

Action 

Server might be 

1. Make sure the web server is running on the system. 

down. 1 nitial 

Restart/Start the web server and then restart the H P 

weight set to 0. 
Exiting. 

LD Control daemon. 

2. Check the parameters in the file 

/etc/hpldc/webstone/con f /server-list. 

3. In /etc/passwd, check for the following entry: 

webstone:trKI3 j iXvewTw:33: 1 : :/tmp:/sbin/sh 

If this entry does not exist, add it to the file. 

4. If the web server is running, make sure it is using a 
non-SSL port. The H P LDControl daemon must use a 
non-SSL port to generate the initial weight. 

Cannot send 

1. The snmp-server host parameter must be set on the 

weight to 

system running Cisco LocalDirector. Refer to Cisco 

LocalDirector. 

Local Director's manual for more information on setting 
this parameter. 

2. Check that LDHostnameis set tothesystem running 
Cisco LocalDirector in the 

/etc/opt/hpldc/conf/ldc . conf file. 
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